Revise supported Linux distributions and versions#1951
Open
yanchoyanev wants to merge 1 commit intoMicrosoftDocs:mainfrom
Open
Revise supported Linux distributions and versions#1951yanchoyanev wants to merge 1 commit intoMicrosoftDocs:mainfrom
yanchoyanev wants to merge 1 commit intoMicrosoftDocs:mainfrom
Conversation
Updated supported Linux distributions and versions for Azure AD sign-in documentation, including breaking changes for specific versions.
Contributor
|
@yanchoyanev : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. |
Contributor
|
Learn Build status updates of commit e993e71:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/identity/devices/howto-vm-sign-in-azure-ad-linux.md | Details |
docs/identity/devices/howto-vm-sign-in-azure-ad-linux.md
- Line 47, Column 171: [Warning: insecure-link - See documentation]
Link 'http://packages.microsoft.com' is insecure. Links to Microsoft sites must use 'https' instead of 'http'.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
Contributor
|
Can you review the proposed changes? Important: When the changes are ready for publication, adding a #label:"aq-pr-triaged" |
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the “supported Linux distributions and versions” guidance for Microsoft Entra sign-in to Azure Linux VMs by simplifying version ranges and adding a note about breaking changes affecting certain distro minor versions.
Changes:
- Replaces explicit per-version listings with simplified minimum-version ranges (for example,
8+,9+). - Adjusts the distribution/version support table entries (including RHEL/openSUSE/SLES formatting and version statements).
- Rewrites the NOTE about breaking changes and extension/package behavior.
| | SUSE Linux Enterprise Server (SLES) | SLES 12, SLES 15.1 to 15.5, SLES 15.6+ | | ||
| | Ubuntu | Ubuntu 16.04 to Ubuntu 24.04 | | ||
| | AlmaLinux | 8+ | | ||
| | Azure Linux (formerly known as Common Base Linux Mariner)| 2.0, 3.0 | |
There was a problem hiding this comment.
The Azure Linux table row is missing a space before the column separator (|) after the distribution name, which makes the table formatting inconsistent and can impact readability. Add a space before the | to match the other rows.
Suggested change
| | Azure Linux (formerly known as Common Base Linux Mariner)| 2.0, 3.0 | | |
| | Azure Linux (formerly known as Common Base Linux Mariner) | 2.0, 3.0 | |
| | Debian | 9+ | | ||
| | openSUSE | openSUSE Leap 42.3, 15+ | | ||
| | Oracle | 8+ | | ||
| | RedHat Enterprise Linux (RHEL) | 7.4 to 7.9, 8.3+ | |
There was a problem hiding this comment.
Possible regression/ambiguity in the RHEL support row: previously the table explicitly listed RHEL 9.0+ as supported, but the new entry only mentions 7.4–7.9 and 8.3+. If RHEL 9 is still supported, update the row to include it; if it’s intentionally no longer supported, consider calling that breaking change out explicitly to avoid confusing readers.
Suggested change
| | RedHat Enterprise Linux (RHEL) | 7.4 to 7.9, 8.3+ | | |
| | RedHat Enterprise Linux (RHEL) | 7.4 to 7.9, 8.3+, 9.0+ | |
|
|
||
| > [!NOTE] | ||
| > SUSE made a breaking change with version 15.6 that is incompatible with the older versions. Since the Microsoft Entra login VM extension always installs the latest package, this will not work on older SUSE versions. You can install the aadsshlogin packages from packages.microsoft.com for older SUSE versions. After adding the repo, one can manually install them with this command: `sudo zypper install aadsshlogin=1.0.027980001`. | ||
| > There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable. |
There was a problem hiding this comment.
Typo: "latests" should be "latest".
Suggested change
| > There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable. | |
| > There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latest version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable. |
|
|
||
| > [!NOTE] | ||
| > SUSE made a breaking change with version 15.6 that is incompatible with the older versions. Since the Microsoft Entra login VM extension always installs the latest package, this will not work on older SUSE versions. You can install the aadsshlogin packages from packages.microsoft.com for older SUSE versions. After adding the repo, one can manually install them with this command: `sudo zypper install aadsshlogin=1.0.027980001`. | ||
| > There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable. |
There was a problem hiding this comment.
Typo: "cpommand" should be "command".
Suggested change
| > There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable. | |
| > There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any command that will result to upgrading aadsshlogin package, because it can render the machine unusable. |
|
|
||
| > [!NOTE] | ||
| > SUSE made a breaking change with version 15.6 that is incompatible with the older versions. Since the Microsoft Entra login VM extension always installs the latest package, this will not work on older SUSE versions. You can install the aadsshlogin packages from packages.microsoft.com for older SUSE versions. After adding the repo, one can manually install them with this command: `sudo zypper install aadsshlogin=1.0.027980001`. | ||
| > There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable. |
There was a problem hiding this comment.
The new NOTE is difficult to follow and has a few correctness/clarity issues: it uses singular/ambiguous wording ("EL-like distribution"), the version ranges appear self-contradictory (for example, "15.0-15.6" includes 15.6), and it uses an http:// URL for packages.microsoft.com (elsewhere in the doc it’s https://). Please rewrite this note to clearly state which distros/minor versions are affected, what the recommended action is, and format the packages URL consistently (prefer https:// and appropriate Markdown formatting).
Suggested change
| > There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable. | |
| > A breaking change affects Enterprise Linux 9.6 distributions, such as RHEL 9.6 and compatible derivatives, and SUSE Linux Enterprise Server 15.6. These releases aren't compatible with `aadsshlogin` package builds intended for earlier minor versions in the same distribution family, such as Enterprise Linux 9.0 through 9.5 and SLES 15.0 through 15.5. Because [packages.microsoft.com](https://packages.microsoft.com/) doesn't provide repositories for every minor version, the VM extension installs an earlier `aadsshlogin` package version on these systems instead of the latest version. To avoid making the machine unusable, don't manually upgrade `aadsshlogin` on affected systems. Stay on the extension-installed version until a compatible package version is available. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Updated supported Linux distributions and versions for Azure AD sign-in documentation, including breaking changes for specific versions.
Removed the explicit enumeration of all supported versions to remove the need of updating this document every time a new version is added.